<div class="section">
  <div class="heading"><div class="title"><strong class="code">$.Color</strong></div></div>
  <div class="box article">
    <h5>创建颜色实例</h5>
    <ul>
      <li><strong class="code">new $.Color()</strong></li>
      <li><strong class="code">new $.Color(hexStr)</strong></li>
      <li><strong class="code">new $.Color(r, g, b)</strong></li>
      <li><strong class="code">new $.Color(r, g, b, a)</strong></li>
      <li><strong class="code">new $.Color(rgbaColor)</strong></li>
      <li><strong class="code">new $.Color(hslaColor)</strong></li>
    </ul>
    <p>参数：</p>
    <ul>
      <li><code>hexStr</code>，16 进制颜色值字符串，需要包括 <code>'#'</code> 前缀；</li>
      <li><code>r</code>，RGB 颜色模型的 R 分量，取值范围 <code>0 ~ 255</code>；</li>
      <li><code>g</code>，RGB 颜色模型的 G 分量，取值范围 <code>0 ~ 255</code>；</li>
      <li><code>b</code>，RGB 颜色模型的 B 分量，取值范围 <code>0 ~ 255</code>；</li>
      <li><code>a</code>，颜色透明度，取值范围 <code>0 ~ 1</code>；</li>
      <li><code>rgbaColor</code>，一个对象来使用 RGB 颜色模型设定颜色，例如 <code>{r: 255, g: 0, b: 255, a: 1}</code>，其中 <code>a</code> 代表透明度，可以省略，默认为 <code>1</code>；</li>
      <li><code>hslaColor</code>，一个对象来使用 HSL 颜色模型设定颜色，例如 <code>{h: 350, s: 0.5, l: 0.9, a: 1}</code>，其中 <code>h</code> 取值范围为 <code>0 ~ 359</code>，<code>s</code> 和 <code>l</code> 取值范围为 <code>0 ~ 1</code>，其中 <code>a</code> 代表透明度，可以省略，默认为 <code>1</code>；</li>
    </ul>
  </div>
  <pre class="prettyprint"><code>var myColor = new $.Color('#095823');</code></pre>
  <div class="box article">
    <h5>判断字符串是否是有效的颜色表达式</h5>
    <ul>
      <li><strong class="code">$.Color.isColor(str)</strong></li>
    </ul>
  </div>
  <pre class="prettyprint"><code>var isColor = $.Color.isColor('#2343x');</code> <span class="muted">// '#2343x' 不是有效的颜色值</span></pre>
</div>

<div class="section">
  <div class="heading">
    <div class="title"><strong>方法</strong></div>
  </div>
  <div class="box article">
    <h5 class="code">rgb()</h5>
    <p>返回一个存储 RGB 颜色模型的对象，例如 <code>{r: 255, g: 0, b: 255, a: 1}</code>。</p>
    <h5 class="code">rgb(rgbaColor)</h5>
    <p>使用一个对象来使用 RGB 颜色模型重新设定颜色，例如 <code>{r: 255, g: 0, b: 255, a: 1}</code>，其中 <code>a</code> 代表透明度，可以省略，默认为 <code>1</code>.</p>
    <h5 class="code">hue()</h5>
    <p>返回 HSL 颜色模型中的 H 分量。</p>
    <h5 class="code">hue(hue)</h5>
    <p>以 HSL 颜色模型，重新设置 H 分量。</p>
    <h5 class="code">darken(percent)</h5>
    <p>以百分比降低颜色亮度。</p>
    <p><code>percent</code> 参数为整数，表示百分比，取值范围 <code>0 ~ 100</code>。</p>
    <h5 class="code">lighten(percent)</h5>
    <p>以百分比提高颜色亮度。</p>
    <p><code>percent</code> 参数为整数，表示百分比，取值范围 <code>0 ~ 100</code>。</p>
    <h5 class="code">clone()</h5>
    <p>克隆一个当前实例的副本。</p>
    <h5 class="code">fade(percent)</h5>
    <p>设定档期透明度为指定的百分比。</p>
    <p><code>percent</code> 参数为整数，表示百分比，取值范围 <code>0 ~ 100</code>。</p>
    <h5 class="code">toHsl()</h5>
    <p>返回一个存储 HSL 颜色模型的对象，例如 <code>{h: 350, s: 0.5, l: 0.9, a: 1}</code>。</p>
    <h5 class="code">luma()</h5>
    <p>返回颜色的亮度。</p>
    <h5 class="code">saturate()</h5>
    <p>返回颜色的饱和度。</p>
    <h5 class="code">contrast(dark, light, threshold)</h5>
    <p>返回颜色的对比色，将当前颜色的亮度与指定的阈值进行比较，如果判断为亮色则返回指定的暗色，如果判断为暗色则返回指定的亮色。</p>
    <p>参数：</p>
    <ul>
      <li><code>dark</code>指定当需要返回一个暗色时使用的颜色，默认为 <code>#000</code>；</li>
      <li><code>light</code>，指定当需要返回一个亮色时使用的颜色，默认为 <code>#fff</code>；</li>
      <li><code>threshold</code>，判断颜色是否为亮色的阈值，默认为 <code>0.43</code>，取值范围为 <code>0 ~ 1</code>。</li>
    </ul>
    <h5 class="code">hexStr()</h5>
    <p>将当前颜色以十六进制字符串返回。</p>
    <h5 class="code">toCssStr()</h5>
    <p>返回当前颜色适合 CSS 的值。</p>
  </div>
</div>
